home *** CD-ROM | disk | FTP | other *** search
- *****************************************************************************
-
- JPClock v1.2
-
- © Copyright 1989 by Jonathan Potter
-
- Another fantabulous Public Domain release
-
- *****************************************************************************
-
- JPClock - the ultimate WorkBench clock!
-
- USAGE :
- JPClock [FLAGS]
-
- Flags are:
-
- -a : Set Alarm on
- -atALARMTIME : Set Alarm time to ALARMTIME (HH:MM:SS or H:MM:SSC)
- -dSECONDS : Set Delay between updates to SECONDS seconds
- -f : Set Stay Front on
- -ot : Turn time display off
- -oy : Turn day display off
- -od : Turn date display off
- -of : Turn fast memory display off
- -oc : Turn chip memory display off
- -ol : Turn total memory display off
- -s : Auto swap to next screen
- -u : USA format; MM-DD-YY instead of DD-MM-YY
- -xX : Open window with x-coordinate X
- -yY : Open window with y-coordinate Y
-
- Since the Amiga's conception, there have been umpteen different clock
- programmes to go with it. The first of these, of course, was the WorkBench
- Clock, and other (third-party?) clocks have followed suit. Each one offered
- slightly different features; all (of course) showed time, some showed free
- memory in the system, and some showed the date. However, I have never found
- a clock programme that is quite flexible enough, with enough features for me.
- Enter JPClock!
- JPClock is quite a short clock programme, around 17K long, however it is
- packed with features. On first appearance, it looks just like any other
- clock, with maybe a little more. A title bar-height window opens at the
- top of the WorkBench screen, displaying the following information
-
- TIME DAY DATE FAST CHIP TOTAL
-
- in the following format
-
- HH:MM:SS DDD DD-MM-YY XXXX XXXX XXXX
-
- (note, as yet I have not found another clock programme that gives all this
- information.) Quite simply, TIME is the current time, DAY is the day of the
- week, and DATE is the date. Note that by specifying the -u flag when running
- JPClock, DATE is displayed in the USA format of MM-DD-YY. FAST is the amount
- of free FAST memory in the system, likewise CHIP is the amount of free CHIP
- memory in the system, and TOTAL is the two added together.
- Activating the JPClock window (which can be closed, dragged and depth
- arranged) by clicking on it, and then pressing the RIGHT MOUSE BUTTON,
- POPs open a larger window with several gadgets in it. Specifically, these
- gadgets are TIME, DATE, ALARM, NEXT SCREEN, STAY FRONT, and ALARM ON.
- TIME allows you to set the system time from within JPClock - simply click in
- the string gadget and type the time in (in the format HH:MM:SS). Note that
- the last two values are optional, however, to change the second or third
- value (minutes or seconds) you must specify the preceding values.
- DATE similarly allows you to set the system date, in the format DD-MM-YY
- (or MM-DD-YY in -u USA mode). Note please that JPClock is not capable of
- handling years past 1999, although it will not crash, the aesthetic balance
- of the clock will be disturbed. I have no doubts, however, that by 1999 much
- more sophisticated clocks will be available (if not computers) :-).
- ALARM allows you to set the Alarm time, ie the time at which the alarm, if
- enabled by the ALARM ON gadget, rings. The alarm ring is simply 10
- DisplayBeeps (screen flashes), accompanied by ten beeps.
- NEXT SCREEN allows you to shove the clock window to the next open screen.
- The window will not move if there is no next screen, or if the next
- screen is not big enough (minimum dimensions are 504x45.)
- STAY FRONT, when switched on (highlighted), will keep the JPClock window
- at the front of the display at all times. This means that you can never
- lose it behind other windows.
- ALARM ON, as explained before, allows you to switch the alarm on or off.
-
- The fourteen startup flags allow to to change the way JPClock is configured.
- The flag -d allows you to change the delay between updates, and
- therefore, the accuracy of the clock. -dSECONDS sets the clock to one update
- every SECONDS seconds, where SECONDS is a number from between 1 and 10.
- The more time between updates, the less CPU cycles the clock will steal.
- The -f flag allows you to automatically set the STAY FRONT option
- on; this is identical in effect to turning it on manually by clicking on the
- gadget.
- Similarly, the -a flag allows you to turn the ALARM on.
- The -u flag allows you to set USA date mode on; ie dates will be displayed
- (and expected to be entered) in the form MM-DD-YY, as opposed to the DD-MM-YY
- format.
- The -o flags allow you to turn various displays in the clock off.
- -ot turns the time display off.
- -oy turns the day display off.
- -od turns the date display off.
- -of, -oc and -ol turn fast, chip and total memory display off.
- Note that you cannot turn everything off; if everything is turned off, time
- is automatically turned back on. The clock window size is changed depending
- on how much information is displayed.
- The -s flag allows you to automatically shove the clock window to the next
- next; of course, if there is no next screen, or the next screen is too
- small, it will not move.
- The -at flag, followed by a time in the form HH:MM:SS will set the Alarm time
- to the time specified.
- The -x and -y flags allow you to specify which position the JPClock window
- will open in initially; these values default to 70 and 0. -xX and -yY opens
- the window with coordinates X,Y.
-
- Please enjoy JPClock, and do not use it for any evil purposes (huh?..)
-
- In case you feel the urge to correspond with me, my address is
-
- 3 William Street
- Clarence Park
- South Australia, 5034
- Australia
-
- and as someone suggested I include it, my 'phone number is 08-293-2788.
-
- Thanks to Torsten Lohr (Eitorf, West Germany) for bug reports.
-
- Jon.
-
- PS: JPClock is Public Domain, you may do whatever you like with it, however,
- if you decide to sell it, at least leave my name in it.
-
- -JP-
-